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(54) Event management service 

(57) An event management service (EMS) is seam- 
lessly integrated into a distributed computing environ- 
ment using existing authentication, event forwarding 
and remote procedure call mechanisms. The EMS pro- 
vides an event channel through which one or more event 
suppliers provide events asynchroncusly to one or more 
event consumers. Events are communicated by issuing 
remote procedure calls (RPC's). Preferably, event sup- 
pliers and consumers are authenticated when register- 
ing for the service. The event management service 
(EMS) includes a filter mechanism for determining 



whether events generated by the one or more event 
suppliers are communicated to the one or more event 
consumers. Each event consumer that registers for the 
service also defines an event fitter group that deter- 
mines whether particular events generated by the one 
or more event suppliers are communicated to that event 
consumer. The event filter group is derived from one or 
more predefined event type schemas and/or event 
header information. Events supplied to the service are 
applied through a parser of the filter mechanism to con- 
trol whether and where a particular event is routed. 
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Description 

The present invention relates generally to computing networks and more particularly to methods for managing 
events in a distributed computing environment. 
5 it is well known to interconnect multiple computers into a local area network (LAN) to enable such computers to 

exchange information and share resources. A local area network provides a distributed computing environment in 
which users can access distributed resources and process applications on multiple computers. An "event* 1 marks a 
change in state of some managed resource in the environment. 

A known distributed computing environment (DCE) has been implemented using software available from the Open 
10 Systems Foundation (OSF). Prior OSF DCE computer network implementations provide event services on a local level 
only. Thus, events generated on a particular machine in the network are only logged or displayed on the machine itself. 
Other machines in the network have no efficient means for receiving notification when events occur in remote resources 
in the network. This deficiency makes it difficult for a system manager to remotely manage other resources in the 
network. 

is There are event service architectures known in the prior art. One known architecture is the DME Event Service 

(EVS), which is described in "DME Event Services Architecture, Version 2.0* by Ferrante, dated April 28, 1993. This 
service uses the concept of event suppliers (who produce event data) and event consumers (who process event data 
generated by the suppliers), but the service has a cumbersome subscription mechanism, is complex and cannot be 
integrated into other existing DCE services. Another known architecture is the OMG Event Service model, which is 

20 described in the "Joint Object Services Submission - Event Service Specification, " OMG TC 93.7.3, dated July 2, 1 993. 
This architecture provides an object-based event service that defines two basic models for communicating event data: 
the push model, which allows event suppliers to initiate the transfer of events to consumers, and the pult model, which 
allows event consumers to request events from event suppliers. Theoretically, an event channel object allows multiple 
suppliers to communicate with multiple consumers in an asynchronous way. The main drawback to the OMG Event 

25 Service model is that there are no currently-available implementations. 

Accordingly, the invention provides a method of managing events in a distributed computing environment wherein 
one or more event suppliers generate events to be communicated to one or more event consumers, comprising the 
steps of: 

30 having an event consumer define an event filter group identifying one or more event filters that include information 

that determines whether particular events generated by the one or more event suppliers are communicated to the 
event consumer; 

parsing a plurality of events through the event filter group to identify one or more events to forward to the event 
consumer; and 

35 communicating to the event consumer the one or more events identified. 

In the preferred embodiment, the event filter group includes one or more event filter names identifying the one or 
more event filters, and each event filter of the event filter group includes one or more filter expressions. The step of 
parsing events through the event filter group includes the steps of: 

40 

(a) determining whether all event filters in the event filter group have been evaluated; 

(b) if all event filters in the event filter group have not been evaluated, selecting a next event filter for evaluation; 

(c) determining whether all of the filter expressions in the next event filter evaluate to a predetermined condition; 

(d) if all of the filter expressions in the next event filter evaluate to the predetermined condition, communicating 
45 the event to the event consumer; 

(e) if any of the filter expressions in the event filter do not evaluate to the predetermined condition, returning to 
step (a). 

In the preferred embodiment, the information is one or more event type schemas each describing an event type 
50 and comprising a list of attribute name/type pairs which specify a data format of an event, wherein an attribute name/ 
type pair comprises an attribute name identifying an attribute of a given event type and an attribute type defining the 
data format in the attribute. Each filter expression of the event filter comprises an attribute name, an attribute operator 
and an attribute value, wherein the attribute operator compares the attribute named in the event and the attribute value. 
The information may also or alternatively comprise a header attribute associated with an event. 
55 The invention also provides a method of managing events in a distributed computing environment in which users 

can access distributed resources and wherein one or more event suppliers generate events to be consumed by one 
or more event consumers, comprising the steps of: 
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having an event consumer define which of a plurality of events generated by the one or more event suppliers are 
to be forwarded to the event consumer; 

having an event management service determine whether an event associated with a predetermined remote pro- 
cedure call (RPC) is one of the plurality of events that is to be forwarded to the event consumer: and 
if the event associated with the predetermined RPC is one of the plurality of events that is to be forwarded to the 
event consumer, supplying the event from the event management service to the event consumer. 



In a preferred embodiment, the predetermined RPC is issued from an event recording service, and the event is 
supplied from the event management service to the event consumer using a remote procedure call. Each event con- 
sumer is registered with the event management service, which preferably authenticates the event consumer with a 
security service. Generally the event suppliers are unaware of the event consumers who have registered with the event 
management service to receive that event supplier's events. It is also preferred that incoming events are saved in an 
event log for backup recovery purposes. 

The invention further provides a computer system for use in a distributed computing environment in which users 
can access distributed resources, comprising: 

event management service means for establishing an event channel through which events are passed from one 
or more suppliers to one or more event consumers; and 

remote procedure call means for supplying events from the one*br more event suppliers to the event management 
service means, and from the event management service means to the one or more event consumers. 

Preferably, the computer system further includes access control means for authenticating event consumers to 
receive events from the event management service means, and event recording service means for providing events 
from the one or more event consumers to the event management service means. 

The invention further provides a computer system for providing an event management service in a distributed 
computing environment in which users can access distributed resources comprising: 

means for establishing an event channel through which events are passed from one or more event suppliers to 
one or more event consumers; and 

means for filtering the events generated by the one or more event suppliers to determine which events are passed 
to the one or more event consumers, wherein the filtering means comprises: 



means for defining an event filter group for each event consumer, the event filter group identifying one or more 
event filters that include information that determines whether particular events generated by the one or more 
35 event suppliers are communicated to the event consumer; and 

means for parsing events through the event filter groups of the event consumers. 



I n the preferred embodiment; the parsing means evaluates event filters in an event filter group to determine whether 
any event filter includes filter expressions that all evaluate to a predetermined condition, wherein the parsing means 
passes the events to the event consumer if any event filter includes filter expressions that all evaluate to the predeter- 
mined condition. 

The invention further provides a method of managing events in a distributed computing environment domain in 
which users can access distributed resources and wherein one or more event suppliers generate events to be con- 
sumed by one or more event consumers, comprising the steps of: 

having each of a plurality of event consumers define which of a plurality of events generated by the one or more 
event suppliers are to be forwarded to the event consumer, wherein at least one event supplier is located on a 
machine remote from an event consumer; 

in response to remote procedure calls from an event recording service, having an event management service 
determine whether an event associated with each remote procedure call is an event that is to be forwarded to any 
of the plurality of event consumers; 

if the event associated with the remote procedure call is to be forwarded to any of the plurality of event consumers, 
using a remote procedure call to supply the event from the event management service to ail event consumers that 
have requested forwarding of the event. 

The above approach allows event management services for both traditional and object-oriented system architec- 
tures wherein managed resources can send asynchronous notifications or "events" to interested parties. Such a system 
enables multiple event suppliers to communicate with multiple event consumers in an asynchronous fashion in a dis- 
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tributed computing environment, and can tightly integrate an event management service into an existing distributed 
computing environment event service to transparently supply events in an asynchronous manner to authorized, remote 
event consumers. Events may be communicated between event supplier and event consumer by issuing remote DCE 
procedure calls (RPC's) by the DCE RPC-based asynchronous event management service, wherein event suppliers 

5 and consumers are authenticated prior to using the service by a DCE security service. 

The preferred embodiment integrates an event management service into a DCE network implementation using 
event forwarding, security and remote procedure call services in the DCE network to filter events generated by one or 
more event suppliers to determine whether particular events are to be communicated to one or more event consumers. 
Event consumers can locate and register with one or more event management services running on multiple host com- 

10 puters in the network. Event consumers can control which host computers send events and the particular types of 
events sent. Event suppliers need not be aware of the event consumers that have registered to receive events. Pref- 
erably, a particular supplier need only send an event once to ensure that interested event consumers receive notification 
of that event. Events are reliably delivered to consumers with minimal network and system load, and in a manner that 
is tolerant of network and machine failures. 

is Thus in a preferred embodiment, a method of managing events in a distributed computing environment is provided 

wherein one or more event suppliers generate events to be consumed by one or more event consumers. The method 
begins by having an event consumer register with an event management service (EMS) to receive selected events 
generated from the one or more event suppliers. In response to a remote procedure call (RPC) from a DCE event 
recording service, the event management service uses a filtering mechanism to determine whether the event associated 

20 with the RPC has been selected by the event consumer If the EMS determines that the event data associated with 
the RPC has been selected by the event consumer, it issues a remote procedure call to supply the event data to the 
event consumer. When multiple event consumers register with the event management service, events occurring on 
remote machines in the network are asynchronously and transparently supplied to event consumers. 

In the preferred embodiment, the event management service is tightly coupled to a DCE event recording service, 

25 although this integration is not necessarily required as the event management service may be accessed directly. Also, 
it is preferred (although not required) that suppliers and consumers be authenticated in connection with registering 
with the event management service, and such authentication may advantageously be carried out by a DCE security 
service. Thus, preferably the event management service takes advantage of existing event recording, security and 
remote procedure call services in the DCE network to provide efficient asynchronous event management. 

30 The filter mechanism controls how event data generated by the event suppliers is passed to particular event con- 

sumers. Each event consumer that registers with the EMS defines an event filter group that determines whether par- 
ticular events generated by the one or more event suppliers are communicated to that event consumer. An event filter 
group includes one or more event filters, each of which is derived from one or more predefined event type schemas 
and/or information in a header associated with each event. The filter mechanism parses events through the event filter 

35 groups of the event consumers. Events that satisfy the parsing protocol for a particular event consumer are commu- 
nicated to that consumer via a remote procedure call. 

In the event service, often multiple event consumers are interested in the same event data, yet event consumers 
may not be able to consume events as fast as they are transmitted from the service. In addition, it is desired that when 
sending an event, suppliers should not be blocked while trying to forward the event to the EMS, and the event service 

40 should not be blocked while attempting to forward the event to interested consumers. To achieve these goals, the Event 
Management Service implements a queueing mechanism that utilizes a number of threads-based services including 
a process control routine to ensure that neither event suppliers nor event consumers take any actions that block the 
event channel. 

Typically the invention is implemented using computer program data encoded in the substrate of the computer- 
^5 readable storage medium, wherein the storage medium so configured causes a computer to manage event data by 
establishing an event channel through which events are passed asynchronously from one or more supplier processes 
to one or more consumer processes. An event management service (EMS) is responsive to remote procedure calls 
(RPC's) for establishing the event channel. 

A preferred embodiment of the invention will now be described in detail by way of example only with reference to 
50 the following drawings: 

FIGURE 1 illustrates a computer network; 

FIGURE 2 illustrates a representative distributed computing domain of connected machines; 

55 

FIGURE 3 is a diagram showing a representative implementation of the event management service within the 
context of a DCE subsystem; 
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FIGURE 4 is a diagram showing how event filters are formulated; 

FIGURE 5 is a flowchart illustrating an event consumer parser routine of the filter mechanism; 
FIGURE 6 is a diagram showing a queue configuration for the event management service; 
FIGURE 7 is a flowchart illustrating an event queue management routine; and 
FIGURE 8 is a block diagram of a computer system. 



A known distributed computing environment (DCE) is illustrated in FIGURE 1 and includes two or more nodes A, 
B and C connected through a communication link or network 3. The network 3 can be a local area network (LAN) or 
a wide area network (WAN), the latter comprising a switched or leased teleprocessing (TP) connection to other nodes 
or to a network of systems operating under a known computer architecture. At any of the nodes A, B or C there may 
is be a processing system 10A, 10Bor 10C. Each of these systems may be a single user system or a multi-user system. 
Each of the processing systems may operate as a client or server, depending on whether it is requesting or supplying 
services. 

Each of the processing systems is a computer, referred to herein sometimes as a "machine." For example, each 
computer may be a RISC System/6000 (a reduced instruction set or so-called RISC-based workstation) running the AIX 

20 (Advanced Interactive Executive) operating system. The AIX operating system is compatible at the application interface 
level with AT&T's UNIX operating system, version 5.2- The various models of the RISC-based personal computers are 
described in many publications of the IBM Corporation, for example, RISC System/6000, 7073 and 7016 POWERstation 
and PQWERserver Hardware Technical Reference, Order No. SA23-2644-00. The AIX operating system is described 
in AIX Operating System Technical Reference , published by IBM Corporation, First Edition (November, 1985), and other 

2S publications. A detailed description of the design of the UNIX operating system is found in a book by Maurice J. Bach, 
Design of the Unix Operating system , published by Prentice-Hall (1986). Another possibility is for each computer to be 
an IBM PS/2 workstation running under the OS/2 operating system. For more information on PS/2 computers and the 
OS/2 operating system, the reader is directed to Technical Reference Manual Personal Systems/2 Model 50, 60 Systems 
IBM Corporation , Part No. 68x2224 Order Number S68X-2224 and OS/2 2.0 Technical Library, Programming Guide 

30 Volumes 1-3 Version 2 00 , Order Nos. 1 0G6261 , 1 0G6495 and 1 0G6494. 

In a preferred embodiment, a plurality of IBM RISC System/6000 machines are interconnected by the Transmission 
Control Protocol/Internet Protocol (TCP/IP) architecture. TCP/IP uses as its link level Ethernet, a local area network 
(LAN) developed by Xerox Corporation. A simplified description of local area networks may be found in a book by Larry 
E. Jordan and Bruce Churchill entitled Communications and Networking for the IBM PC , published by Robert J. Brady 

35 (a Prentice-Hall Company) (1983). 

The skilled person will appreciate that although the invention is described in the above-identified context, it is also 
applicable to many different machines, software systems, configurations and networks, other than those specifically 
described. 

The distributed computing environment may have any number of machines, and these machines may be located 
40 jn different geographic locations. For illustrative purposes, the remainder of the detailed discussion is directed to a 
DCE domain or "cell," which is a relatively smaller version of the network (with up to about 25 machines), although the 
teachings of the invention are applicable to any distributed computing environment: whether traditional, such as Simple 
Network Management Protocol (SNMP) or Common Management information Protocol (CMIP), or whether object- 
oriented. 

45 figure 2 shows a representative DCE cell 12 comprising a set of connected machines, including at least one 

server 14 and the DCE clients 16, which share a common cell name and a namespace. Each cell provides a location 
independent namespace service called CDS, or Cell Directory Service 15. The naming service is used by application 
i servers to store their location and interfaces, known as server bindings. The cell typically includes one or more other 

server machines that provide other services of the distributed computing environment. These other services include, 
so without limitation, a Security Service 18, which facilitates authentication, and an Event Recording Service 20, which is 
a DCE service that application developers may use to record application events. 

In a known DCE implementation, events are of several types. "Service" events typically include such things as 
error messages, warnings, abort messages and generic resource information. Another type of event is an "audit" event. 
Known DCE implementations include a Serviceability (SVC) interface and an Audit interface within the Event Recording 
55 Service 20 for processing these events. The SVC and Audit interfaces allow recording of events. 

In accordance with the present invention, and as will be described in more detail later calls to the Serviceability 
and Audit interfaces within the Event Recording Service 20 are automatically provided via remote procedure calls 
(RPC's) to an Event Management Service (EMS) 22, which is also a server called "emsd," to facilitate asynchronous 
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event management of events by and among so-called "event suppliers" and "event consumers." The EMS 22 may also 
be reached by being called directly For convenience, the passage of events through the SVC or Audit interfaces is 
sometimes referred to a first level or "supplier-side" event filtering. Generally, an event supplier is a DCE-based appli- 
cation (including DCE core servers) which emits events. An "event" refers to the change of state of some managed 

5 resource and is embodied in the data transmitted between an event supplier and EMS, and between EMS and one or 
more event consumers. Such event data consists of an event header, and a list of event attributes which contain event 
type specific data. In one implementation, all DCE applications that use the SVC or Audit interfaces of the Event 
Recording Service 20 are event suppliers. An "event consumer" is any DCE server application which registers with the 
EMS 22 (as will be described) to receive and process events from one or more "event suppliers." 

10 Turning now to FIGURE 3, a diagram is shown illustrating one preferred embodiment of the event management 

service of the present invention within an existing DCE system. The DCE subsystems and functionality are illustrated 
and include the DCE SVC and Audit interfaces 28 and 30, and remote procedure call (RPC) mechanisms 31 . An EMS 
Application Programming Interface (API) 32 may be used by event supplier(s) to reach the Event Management Service 
22. EMS 22 acts as an "event channel" to uncouple one or more event suppliers 24a-24n from the one or more event 

is consumers 26a-26n. Communications through the event channel are "asynchronous" in that they may be provided to 
the event consumers at any time. Event consumers may be local or remote processes as shown. Communications 
between event suppliers and the EMS, on the one hand ; and between the EMS and event consumers, on the other 
hand, are carried out using remote procedure call mechanisms of the DCE system. The portion of the drawing within 
the dotted line reflects (for representative purposes only) a single host computer of the distributed computing environ- 

20 ment on which the EMS 22 and the plurality of DCE event suppliers 24 reside. The Event Recording Service 20 includes 
audit trails 34, SVC log files 36 and a console 38 where management functions are carried out. 

As will be described in more detail below, the Event Management Service includes a number of databases and 
memory structures: a Consumer Database 40, an Event Log File 42, and Event Type Database 44, and an Event Filter 
Database 46. In order to start receiving events, it is preferred that an event consumer must first register with EMS 22. 

2S One representative technique for registering an event consumer includes providing the event consumer with a handle 
describing a connection to the event service and then having the consumer use that handle to issue an RPC to EMS. 
EMS then places an entry in the Consumer Database 40 that uniquely identifies the consumer. A "supplier" registers 
. with the event management service by receiving a handle. The registration process thus defines a connection to a 
specific EMS process running on a. specific machine. Although not required, registration may also involve having the 

30 event consumers and event suppliers authenticate themselves with the DCE Security Service (not shown). 

Consumers that have registered with EMS are identified in the Consumer Database 40. The Event Log File 42 
stores a collection of events to be sent to event consumers. The event log stores events in case EMS cannot forward 
events to all appropriate event consumers (e.g., because network connections are down). An event is deleted from 
the event log after that event is forwarded to all relevant consumers. 

35 Before the event consumer can receive event data, however, it must also define a "filter* which EMS then uses to 

determine whether particular events from the one or more event suppliers gets passed to that event consumer. Initially, 
the event consumer uses general "event type* information in the Event Type Database 44 to create an particular "event 
filter group* for that consumer. As will be seen, the information in the Event Type Database 44 is also used by event 
suppliers and, possibly, an EMS administrator. The filter data selected or specified by an event consumer is then stored 

40 in the Event Filter Database 46. 

Event Type Database 44 stores information used by EMS and event suppliers and consumers to generate "event 
types* each of which are a class of events that have the same event type format. An event type format is described 
via an m event type schema" and identified by a unique universal identifier (UUID). An event type schema is a description 
of an event type and consists of a list of attribute name/type pairs which specify the data format of an event. An attribute 

45 name is a string that uniquely identifies an attribute of a given event type. An attribute type is the data type of an event 
attribute, which defines the format of the data in the attribute. Event type schema data (stored in database 44) and/or 
event header information is used by an event consumer to construct an 'event filter group" to tell EMS which events 
to forward to that consumer. 

Referring to FIGURE 4, an event filter group is a collection of one or more "event fitters" which are logically ORed 
so together. There is one event filter group per registered event consumer. An "event filter 9 is a collection of one or more 
"filter expressions? which are logically ANDed together, and each event filter has an event filter name and event type 
(which may be generic). As many event filter names as desired can be added to a consumer's event filter group to 
control what events EMS will send to that consumer. The event firter names are listed in the Consumer Database. An 
event filter expression" is preferably a 3-tuple consisting of the attribute name, the attribute value, and an attribute 
55 operator which defines a compare operation. The attribute operator in a filter expression is used to effect the comparison 
between the named attribute in the event and the attribute value. The attribute name in a firter expression may refer 
to an attribute name in an event type schema or header information. Thus, for example, if the header information 
includes time-stamp information, the event filter group may contain a filter having an event filter expression that refers 
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to time-stamp information in the header. 

Referring back to FIGURE 3, to reach EMS an event passes through the Event Recording Service to EMS or EMS 
is called directly. Once the event arrives at EMS via a remote procedure call (RPC), it is stored in the Event Log 42. 
EMS 22 then performs a parsing operation to determine whether the event gets passed on to any event consumers. 
s The information stored in the Event Filter Database 46 is a second stage or "consumer-side" EMS filter 45 that EMS 
22 uses to make this evaluation. The second state filtering process is also illustrated in the flowchart of FIGURE 5. 
After filtering, a queueing mechanism 47 is used (as discussed below) to control the flow of events to the interested 
consumers. After the event is forwarded to all interested consumers, it is deleted from the Event Log 42 (and the 
queues). 

to The filtering routine begins each time an event reaches EMS. At step 52, EMS retrieves the event type schema 

for the particular event from the Event Type Database. At step 53, EMS 22 goes through the list of registered event 
consumers in the Consumer Database 40. For each registered consumer, the following processing occurs. At step 54, 
the registered consumer's event filter group is first retrieved from the Consumer Database. As described above, each 
event filter group refers to a collection of one or more filters, each of which include a list of one or more filter expressions. 

75 A parser protocol is then initiated. In particular, at step 56, the routine determines if all filters in the event filter group 
have been evaluated. If not, the routine continues at step 58 by evaluating a next filter in the event filter group. Within 
each filter, the routine looks at each filter expression. A test is then performed at step 60 to determine if all of the filter 
expressions within a particular filter are a predetermined condition, namely TRUE. If so, the routine passes the event 
to the RPC mechanism for delivery to the registered event consumer (step 61). If the outcome of the test at step 60 

20 indicates that any one of the filter expressions in the filter is FALSE, then the routine returns to step 56 to obtain a next 
filter in the event filter group (as identified by a next event filter name). If the outcome of the test at step 56 indicates 
that all filters of the consumer's event filter group have been evaluated, the routine ceases and EMS goes on to the 
next consumer Thus, according to the parser, unless all filter expressions in a particular filter of an event filter group 
are TRUE, the event is not forwarded by EMS to the event consumer. 

25 Referring briefly back to FIGURE 3, an event consumer may use the Consumer API to define a new event filter 

and add it to an event filter group. A consumer may also obtain a list of existing event filter names and add one of 
those event filter names to an event filter group. Event filter names (and thus filters) can be added or deleted from 
event filter groups by the consumer (through the Consumer API) as well as by an EMS administrator through a Man- 
agement API as shown. Thus, the event consumer may modify the event fitter group to add or delete new filters 

30 Event type schemas stored in the Event Type Database are preferably used in several different ways. A consumer 

can request a list of supported event types and pick which event types it wants to receive by using the event type 
schemas to construct event filters. An event consumer also can map events according to attribute names. Event sup- 
pliers use event type schemas to define new event types they intend to produce. EMS uses event type schemas to 
apply event filters to events. 

35 in many cases, multiple event consumers are interested in the same events, yet event consumers may not be able 

to consume events as fast as they are transmitted from the service. In addition, it is desired that when sending an 
event, suppliers should not be blocked while trying to forward the event to EMS, and the event service should not be 
blocked while attempting to forward the event to the interested consumers. To achieve these goals, the Event Man- 
agement Service implements the queueing mechanism 47 which comprises queue defining data structures and a set 

40 of queue manipulation routines. These routines preferably use another existing DCE service, DCE Threads, to provide 
event queue management for the DCE Event Management Service. As is known in the art, threading allows multiple 
routines conceptually to run simultaneously and to share resources. The DCE Threads service is a set of routines that 
can be used to create a multi-threaded program. Multi-threading is used to improve the performance of a program by 
allowing pieces of the program to operate concurrently. DCE Threads is a user-level (nonkernel) threads package 

45 based on the PTHREADS interface specified in "Draft 4 Of The POSIX 1003.4 Standard," which is hereby incorporated 
by reference. 

This event queue mechanism is now generally described with reference to FIGURE 6. Whenever an event con- 
sumer registers with the EMS 22, a consumer queue 70a for that consumer is established within EMS. As seen in 
FIGURE 6, the consumer process also has a corresponding event queue 72a. The event service maintains two queues, 

50 an input queue 74 and an active queue 76. Each queue has a number of queue elements, and each queue element 
can have one of two types of data: a pointer to an event, or a pointer to another queue element. The active queue 76 
of EMS has elements pointing to events that have not been sent to all interested consumers (i.e. those that have 
registered to receive the event in question), with each queue element corresponding to one event. Each queue element 
in the active queue also has a mutex protected count of how many relevant consumers have yet to receive the event. 

55 The consumer queues 70 of EMS have elements that contain pointers to elements in the active queue 76. Suitable 
routines of the queue mechanism are used to create and initialize a queue, to destroy a queue, to enqueue (e.g., 
"push") an element on a queue, to dequeue (e.g., "pop") an element off a queue, to delete an element from a queue, 
and to activate a queue (after restoring it). 
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Referring now to FIGURE 7, the queue management routine is now described in detail. The routine begins at step 
80 by setting up a consumer queue 70 for each registered event consumer When an event is sent to EMS 22, it is 
immediately placed on the input queue 74, and the RPC routine returns. This is step 82 in FIGURE 7. A routine of the 
queue mechanism (called input queue process element), which is running in a separate DCE thread : is then signalled 

5 at step 84. This indicates that the input queue 74 is not empty. At step 86, each element is dequeued from the input 
queue 74. If any consumer is interested in the event that the element points to, then a pointer to that element is 
enqueued onto that consumer's queue 70 (in the EMS) at step 88 and a count associated with the element is incre- 
mented (to indicate that another event consumer is registered to receive the event). At step 90 (after the consumer 
queues 70 of the interested consumers have been updated to receive pointers), the queue element for the event is 

io then pushed onto the active queue to wait for all the consumers to receive the event. At this time, the count represents 
the number of relevant event consumers (namely, those who want notice) who EMS must then notify of the event. 

When an element is enqueued onto one of the consumer queues 70 (of the EMS), the thread running the consumer 
queue process element routine is signalled, as indicated at step 92, and that routine pops the element off the queue 
and sends it to the associated consumer queue at step 94. Once sent, the count associated with the queue element 

75 (in the active queue) is decremented at step 96. If the count reaches zero, all interested consumers have been notified 
and the queue element is deleted from the active queue as indicated at step 98. 

Each of the steps 92, 94 and 96 are carried out in a distinct thread, and thus multiple instances of these steps 
occur simultaneously (at least conceptually) with respect to the consumer queues. When alt threads have been suc- 
cessful in sending the particular event, the event is deleted Irom the active queue (and the Event Log 42). 

20 As noted, each consumer process also has an event queue 72 as seen in FIGURE 6. When an event is sent to 

the consumer, the event is put on this queue, and a signal is sent to the process element routine, which in turn pops 
elements off the consumer queue 72, and calls an event handler routine to retrieve the event. 

The event management service as implemented in an OSF DCE will now be described in more detail. As noted 
above, the DCE EMS manages event services in a DCE cell. EMS preferably consists of two major parts, the emsd 

25 server and the API to access event services. The emsd is a DCE server which may reside on every DCE host in the 
cell from which consumers will request events. It is also envisioned that emsd runs in a distributed fashion. Three 
interlaces are exported by emsd to support EMS suppliers, consumers and event services administration. The. EMS 
API provides an interface to the same three interfaces for use by EMS clients. 

The following sections describe in detail how EMS works along with a description of how to define event types, 

30 the event flow through EMS, how event filters work, how events get logged, and the security model used to protect 
both event data, and event filter definitions. 

Event Flow Description 

35 As noted above, EMS sets up an event channel to decouple the communications between the supplier and con- 

sumer. In order to start receiving events, preferably an event consumer first registers with EMS, then sets-up an event 
filter group to tell EMS which events to forward to that consumer. Before a supplier can send an event to EMS, the 
event typically passes through the first stage event filter. In this embodiment, first stage filtering is achieved at the 
supplier level by using SVC and Audit facilities. Once the event passes through the first stage fitter, it is sent to EMS. 

40 EMS writes the event to the EMS Event Log in order to save the event in case the event cannot be immediately delivered. 

Once the event reaches EMS, it passes through the second stage filter before being forwarded to interested con- 
sumers. Preferably, this is achieved by having EMS go through the list of registered consumers and use the event type 
schema from the Event Type Database, the consumers event filter group from the consumer Database, and the event 
filters from the Event Filter Database to determine for each consumer if this event passes through to be forwarded on. 

45 After all appropriate consumers receive the event, then the event is removed from the event log. 

Event Type Definition 

The format of EMS event types preferably are defined by event type schemas, and are kept in the EMS Event 
so Type Database. The event type schemas typically consist of a list of attribute names along with the attribute type which 
specifies the data format of the data associated with that attribute. Each event is associated with a fixed header part 
and a variable length data part. The variable length data part preferably consists of N self-defining data items which 
consist of an attribute type, then the data itself. The data elements in the variable length part correspond in order one 
for one with the list of attribute name/type pairs defined in the event type schema. The variable length part can have 
55 additional unnamed data items at the end of the named data items (i.e. the data items that have attribute names). 
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Generic Event Types 



EMS supports events with type Generic. Generic events do not have an event type schema. The only way to define 
filters for generic events, is to use filter expressions with event header attributes. 

Default Event Types 

The following is the definition of the SVC and Audit event attribute lists which are contained in their event type 
schemas: 



w 



15 



20 



25 



30 



35 



#define CNT_SVC_ATTRS (si2eof(svc)/sizeo<(ems_attributeJ)) 

static ems_attribute_t svc[] = { 

{(unsigned char •yverston", {ems_c_attr_ 

{(unsigned char *)T, {ems_c_attr_ 

{(unsigned char yargtypes", {ems_c_attr_ 

{(unsigned char # ) M table_Jndex'\ {ems_c_attr_ 

{(unsigned char ^"attributes", {ems_c_attr. 

{(unsigned char *)"me$sage_index , \ {ems_c_attr_ 

{(unsigned char *pormar, {ems_c_attr 

{(unsigned char *pile", {ems_c_attr 

{(unsigned char *) M progname ,t , {ems_c_attr 

{(unsigned char yiine H , {ems_c_attr 

{(unsigned char # ) n threadid H f {ems_c_attr 

{(unsigned char Tcomponent_name", {ems_c_attr 

{(unsigned char *) w sc_name*\ {ems_c_attr 



ulongLint,0} }, 
utc.O} }, 

char_string,0} }, 
utong_int,0} }, 
_ulongLint ( 0} }, 
_utongLJrTt ( 0} }, 
„char_string,0} }, 
_char_strtng t O) }, 
_char_string,0} }, 
_ulongjnt f 0} }, 
.ulongjnt.O} ) f 
,char_string,0} }, 
_char_string,0} }, 



40 



45 



{(unsigned char *)"attribute debug", 
{(unsigned char # )"attribute.severity" I 
{(unsigned char yattribute.actroute", 

}; 



{ ems_c_attr_u shortjnt, 0} }, 
{ems_c_attr_ushort_intO} }, 
{errc_c_attr_utong_jnt,0} } 



so 



55 



Several constants have also been defined to use to match against the attribute.severity attribute. They are: 

♦ SVC_C_SEV_FATAL 

♦ SVC_C_SEV_ERROR 

♦ S VC_C_S E V_WAR Nl N G 

♦ SVC_C_SEV_NOTICE 

♦ S VC_C_S E V_NOTI C E_VE R BOS E 
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#define CNT_AUDIT_ATTRS (sizeof(aud»)/sizeof(ems_attribute_t)) 
ems_attribute_t audrtQ = { 

{(unsigned ctiar*porrnaf\ {ems_c_attr_ushort_int,0} }, 

{(unsigned charTserver. {ems_c_attr_uuid,0} }. 

{(unsigned char*) M event\ {ems„c_attr_ulong_int,0} ), 

{(unsigned char*)"outcome", {ems_c_attr_ushortJnt,0} }, 

{(unsigned charTauthz_sT. {ems_c_attr__ushort_int,0) }, 

{{unsigned chafpime", {ems_c_attr_utc , 0} } ( 

{(unsigned charTaddr", {ems_c_attr_char_string,0} } 

): 

20 Event Filters 

EMS supports the concept of two stage tittering. First stage tittering is applied on the machine that the supplier is 
running on to filter out events before they are even sent to EMS. Second stage filtering is applied by EMS to events 
received from suppliers. This stage controls which events get forwarded on to consumers. 
25 The following sections describe the two stages of filtering EMS supports as well as how to define and organize 

the event filters. 

First and Second Stage Filtering 

30 in one embodiment, SVC and Audit event types are supported. The first stage filter for SVC events are the SVC 

routing destination. SVC messages that are routed to EMS will be sent through the EMS event channel. For Audit, 
audit records that pass through the audit filter mechanism are sent through the EMS event channel. 

The second stage filter is defined per EMS consumer. This stage associates an event filter group with each event 
consumer, and that consumer only receives events that pass through one of the entries in the consumer's event filter 

35 group. 

Defining Event Filters 

A typical scenario of how an event consumer would start interfacing with EMS would be for the consumer to first 
^0 query EMS about what event types are supported. From that list of event types, the consumer could then query the 
event type schema, to construct any event filters for that event type. The event type schemas preferably contain the 
list of attribute names, and attribute types which the consumer would use to construct an event filter. The consumer 
would then tell EMS to apply the constructed event filter to incoming events by adding it to the consumer's event filter 
group. 

4 5 EMS filters may be constructed at several different levels. The lowest level is the filter expression, which typically 

is a 3-tuple consisting of an attribute name, attribute operator, and an attribute value which defines a compare operation. 
AH compare operations evaluate to a boolean value. Only certain attribute operators are allowed on certain attribute 



4 types 



The following are some examples of a filter expression: 



so 



ss 
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ems_filter_exp_t xmp_SVC, xmp_Audrt; 



xmp_S VC attr_name 



= "file"; 



5 



xmp_SVC.attr_operator 



« ems_c_attr_op_eq ; 



xmp_S VC .attr_comp_value.type 



= ems_c_attr_char_string ; 



xmp_SVC.attr_comp_value.tagged_union.char_string = "file.c"; 



10 



15 



x mp_ Aud it . att r_name = "outcome"; 

x mp_ Au d it . att r_ope ra to r - ems_c_attr_op_eq; 

xmp_Audit.attr_comp_value.type = ems_c_attr_ushort_int; 

xmp_Audit.attr_comp_value.tagged_union.ushort_int = aud_c_esl_cond_denial; 



20 



The first example will evaluate to TRUE if the attribute name "file" of an SVC event type is equal to the string "file.c". 
In the second example, the filter expression xmp_Audit will evaluate to TRUE if the attribute name "outcome" of an Audit 
event type is equal to the attribute value aud_c_esl__cond_denial, which means that an Audit event is recording that access 
25 was denied for some action. 

An event filter typically is made up of a list of filter expressions that are added together. An event filter has both a 
name, and an event type. The event filter name is used to refer to the event filter in event filter create, delete and 
update operations. The event filter name is also used by consumers and EMS administrators to add event filters to an 
event filter group. 

30 A consumer's event filter group preferably is a collection of one or more event filter names. For an event to pass 

through a consumer's filter group, the event filter associated with each event filter name specified in the event filter 
group is applied to the event. If all the event filter expressions in the named event filter evaluate to TRUE, then the 
event is forwarded by EMS to that consumer (because of the logical AND operation). If any of the event filter expressions 
evaluate to FALSE, then the event filter specified by the next event filter name in the event filter group is applied to the 

35 event. If none of the event filters in the event filter group evaluate to TRUE, then the event is not forwarded to that 
consumer. 

Filtering on Header Information or Event Type 

40 a predefined set of event header attribute name/type pairs have been defined to allow filtering on the information 

in the event header Filter expressions with event header attributes can be part of filters with event type specific header 
attributes. Filters with type Generic, however, can only have filter expressions with header attributes. 

EMS Event Log 



The EMS event log is used to store events in case of EMS failures. EMS writes all events to the event log, and 
deletes the event record once the event has been transmitted to all consumers that are supposed to get the event. 

The event log is kept in a file on the machine where emsd is running. Events are stored in a directory specified 
by the environment variable EMS_EVENTLOG_DIR. An API is provided to examine local event logs. 



EMS Security Model 

EMS provides for secure manipulation of data in the EMS databases. This includes the Event Filter Database, the 
Event Type Database as well as the list of consumers in the Consumer Database. EMS also provides for supplier and 
55 consumer authentication and authorization as well as secure transmission of event data. All access control lists (ACL's) 
are associated with names in the DCE namespace, and the emsd server manages the namespace past the junction: 



45 



SO 
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/. :/hosts/<hostname>/ems-server/ 



10 



15 



20 



2S 



The ACL associated with this object will control access to the emsd server registered in this namespace. The 
permissions associated with ems-server: 

Table 1 : 



emsd Server Permission Bits 


Permission bit 


Name 


Description 


c 


control 


Modify the ACLs on the server 


r 


read 


Read the attributes for this server 


s 


stop 


Stop the EMS server 


w 


write 


Modify the attributes on this server 



Three security objects are maintained under the ems-server junction. The directories and the databases they 
represent are: 



event-types 


Event type Database 


filters 


Filter Database 


consumers 


Consumer Database 



30 



Each of these databases has an ACL associated with it. 
Event Type Security Management 

The Event Type database is represented by the following name in the DCE name space: 



35 



40 



45 



so 



/. 7hosts/<hostn^une>/erns-server/event-types 

The ACL associated with this object controls access to this database. The permissions associated with event- 
types are: 

Table 2: 



Event Type Database Permission Bits 


Permission bit 


Name 


Description 


c 


control 


Modify the ACLs on the server 


d 


delete 


Delete an event type schema 


i 


insert 


Add an event type schema 


r 


read 


Read the contents of event type schemas 



EMS event data access can be granted per event type. Authority on event data of a given event type can be granted 
by modifying the ACL on: 

/.:/hosts/<fx>$tname>/ems-se 



where <event_type_name> is the event type name which appears in the event type schema. The following names are 
55 recognized for SVC and Audit events: 
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/.:/hosts/<hostname>/ems-server/events/SVC 
/.7hosts/<hostname>/ems-server/events/Audtt 



The permissions associated with <event_type_name> are: 

Table 3: 



Event Type Permission bits 


Permission bit 


Name 


Description 


c 


control 


Modify the ACLs on the event type 


d 


delete 


Delete this event type 


r 


read 


Read (Consume) an event of this type 


w 


write 


Write (Supply) an event of this type 



A supplier's access rights may be verified on the first event sent to EMS, and the consumer's access rights may 
20 be verified before forwarding events to that consumer. Authenticated RPC is used to access the EMS supplier and 
consumer Remote API. 

Event Filter Security Management 

2S The Filter Database is represented by the following name in the DCE name space: 



30 



35 



40 



45 



so 
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/. :/hosts/<hostname>/ems-server/filters 

The ACL associated with this object controls access to this database. The permissions associated with filters are: 

Table 4: 



Filter Database Permission Bits 


Permission bit 


Name 


Description 


c 


control 


Modify the ACLs on tutors 


d 


delete 


Delete an event filter 


i 


insert 


Add an event filter 


r 


read 


Get a list of or the contents of event filters 



Event filter access control is granted per event filter. Authority on filter access for a given event filter is granted by 
modifying the ACL on: 

/.7fx>sts/<hostname>/ems-server/fitters/<filter - name> 

where <filter_name> is the event fitter name given to the event filter on the call to ems_fitter_add. 
The permissions associated with event filters are: 

Table 5: 



Event Filter Permission Bits 


Permission bit 


Name 


Description 


c 


control 


Modify the Acl on the event filter 


d 


delete 


Delete the event filter 
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Table 5: (continued) 



Event Filter Permission Bits 


Permission bit 


Name 


Description 


w 


write 


Modify the contents of an event filter 



When a consumer creates an event filter, that consumer principal automatically gets dwc permissions on the 
created event filter. 

10 

Consumer Security Management 

The Consumer database is represented by the following name in the DCE name space: 

15 /.:/hostsy<hostname>/ems-s«rver/consumers 

The ACL associated with this object controls access to this database. The permissions associated with consumers 

are: 

20 

Table 6: 



Consumer Database Permission Bits 


Permission bit 
c 


Name 
control 


Description 
Modify the ACLs on consumers 


d 


delete 


Delete a consumer 


t 


insert 


Add (register) a consumer 


r 


read 


List consumer information 


w 


write 


Modify a consumer including his filter group 



EMS Security Initialization 

35 When EMS is configured, several security groups are created by default. The groups are ems-admin, ems-con- 

sumer, and ems-supplier. The default permissions are: 

40 



45 



so 



ss 
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/. :/hosts/<hostname>/ems-server 

object acl 

ems-admin crws 

hosts/<hoslname>/setf rws 

any_other r 

/.:/hosts/<hostname>/ems-server/event-types 
object acl 

75 ems-admin cri 

ems-consumer r 

ems-supplier ri 

any_other r 

initial object acl (/. :/hosts/<hostname>/ems-server/event 

types/<event_type_name>) 

ems-admin cdw 
ems-consumer r 
ems-supplier w 
/. :/hosts/<hostname>/ems-server/f liters 
object acl 

ems-admin crdi 

ems-consumer ir 

any_other r 

40 



20 



25 



30 



35 



45 



SO 



initial object acl (/.:/hosts/<hostname>/ems-server/fllters/<filter_name>) 

ems-admin cw 

/.:/hosts/<hostname>/ems-server/consumers 
object acl 

ems-admin cdrw 
ems-consumer irw 
55 any_other r 

By setting these permissions for the ems_admin group, each new event filter and event type created will auto- 
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matically inherit the same permissions. 

Administrators can acid principals to each of these groups to give them access to all emd's running in a cell. If 
tighter security is desired, the group can be removed from the respective ACL, and principals can be added. 

When transmitting events of type Audit. EMS preferably will use authenticated RPC set to DCE Security Protection 
5 Level strong integrity (rpc_c_protect_leveLpkt_integrity). 

Writing Consumers 

Preferably, event consumers are not simple clients but rather are implemented as servers. This is not required, 
10 however. Each EMS consumer will likely have certain requirements: calling consumer_start, registering an event han- 
dler, registering with the various emsd's that the consumer desires to receive events from, setting-up event filters, and 
calling rpc_server_listen. 

The call to consumer_$tart creates the consumer uuid, and then registers the EMS Transmit to Consumer handler. 
The call to ems_consumer_handler_registen sets up an incoming consumer queue, and initializes the event handler 
'5 function to call the handle function specified. One event consumer can register to receive events from multiple emsd 
servers on different hosts. Consumers must set up event filters before any events will be sent. Finally, it is up to the 
consumer to call rpc_server_listen to wait for incoming events. 



20 



EMS Recovery After Restart 



EMS stores all state data in the following repositories 

Consumer Database- 
Contains a list of all suppliers, and all consumers as well as the list of filters in the consumer filter group. 

Event Type Database- 
's Contains the schemas for all the known event types. 

Event Filter Database- 
Contains all the current filter definitions. 

When an emsd is restarted, the following steps are performed: 

30 1 . All databases get restored 

2. All consumers are told to reregister or reconnect 

3. The event queue is restored from the event log files 

4. event transmission proceeds 

35 Event Queue 

An event queue contains the following features: 

Empty and full condition variables. These variables wait until the queue is not Empty or not full respectively. 
They can be turned on and off if required. 
40 queue mutex. Used for pushing and popping elements onto the queue to provide multithreaded access to a queue. 

process element routine. This is a user written routine with a defined signature which is called to process queue 
elements. Each queue gets its own thread which calls this routine. 

Maximum queue size. When the queue reaches this size, it waits on the full condition variable until not full. 
Queue persistence. Each element on the queue is saved using DCE backing store so if the EMS goes down, the 
45 event queues can be restored. 

Event queue elements 

Event queue elements can contain two types of data: 

so 

* A pointer to an Event 

• A pointer to another queue element 

This allows EMS to have an active queue with elements pointing to events that have not been sent to all interested 
55 consumers, and consumer queues with elements that contain pointers to elements in the active queue. Each element 
also contains a mutex protected count of how many pointers to that element are active. 
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Data Structures 

EMS Event Attributes 

5 Event Attribute Types 

The event attribute type is used to specify the data type of an event attribute. The attribute type specifies what 
format the data is in in the event attribute value union (ems_attr_vaiue_t). 
All event attribute types are defined as 

10 

typedef unsigned 1 6 ems_attr_type_t ; 

An event attribute type can be one of the following: 

15 

Table 7. 



25 



30 



35 



40 



45 



Event Attribute Type Specifiers 


Attribute Type 


Data Type 


Size 


ems_c_attr_small_int 


idl_small_int 


1 byte 


ems_c_attr_short_int 


idLshort_int 


2 bytes 


ems_c_attr_long_int 


idl_long_int 


4 bytes 


ems_c_attr_hyper_int 


idl_hyper_int 


8 bytes 


ems_c_attr_usmall_int 


idl_usmaiUnt 


1 byte 


ems_c_attr_ushort_int 


idl_ushort_int 


2 bytes 


ems_c_ulong_int 


idl_ulong_int 


4 bytes 


ems_c_attr_uhyper_int 


idl_uhyper_int 


8 bytes 


ems_c_attr_short_float 


idl_short_float 


4 bytes 


ems_c_attr_tong_float 


idl_long_float 


8 bytes 


ems_c_altr_booiean 


idl_boolean 


1 byte 


ems_c_attr_uuid 


uuidj 


16 bytes 


ems_c_altr_utc 


utc_t 


16 bytes 


ems_c_attr_se verity 


ems_severity_t 


4 bytes 


ems_c_altr_acl 


sec_acl_t* 


variable size 


ems_c_att r_byt e_st ring 


idl_byte* 


variable size 


ems_c_attr_char_strtng 


idl_char* 


variable size 


ems_c_attr_bytes 


see structure 


variable size 



Byte strings and character strings are terminated with a 0 (zero) byte. The pickling service of the IDL compiler can 
be used to encode complex data types into byte strings that are to be included in an EMS event. - 

so Event Attribute Values 

The event attribute value union is a self defining data structure which has an attribute type specifier (type) which 
tells what type of data is in the union, and then appropriate union members to hold the value of the data specified. 

55 
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typedel struct ems_bytes_s_t { 

unsigned32 size; /* size of byte data 
(sizejs(size)] 

byte # data; r byte data V 

} ems_bytes_t; 

typedef union switch (ems_attr_type_t format) { 
case erns_c_attr_small_int: 

small int small_tnt; 
case ems_c_attr_short_int: 

short int shorMnt; 
case ems_c_attr_k>ng_int: 

long int tongjnt; 
case ems_c_attr_hyper_int: 

hyper int hypeMnt; 
case ems_c_attr_u smalLint : 

unsigned small int usmalHnt; 
case ems_c_attr_ushort_int: 

unsigned short int ushort_int; 
case ems_c_attr_u tong_int: 

unsigned long int ulongjnt; 
case ems_c_attr_uhyperjnt: 

unsigned hyper int uhyperjnt; 
case ems_c_attr_short_f loat : 

float short Jloat; 
case ems_c_attr_long_float: 

double long_float: 
case ems_c_attr_bootean: 

boolean boot; 
case ems_c„attr_uuid: 
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uukl_t uukJ; 
case ems__c_attr_utc: 

utc_t utc; 
case ems_c_attr_acl: 

sec_acM * acl; 
case erns_c_attr_byte_string: 

[string] byte * byte_string; 
case ems_c_attr__char_string: 

[string) char * char_string; 
case ems_c_attr_bytes: 

ems_bytes_t * bytes; 

default: 



} ems_attr_value_t ; 



Event Attribute 



Event attributes typically contain an event attribute name/type pair which define an event attribute. Event attributes 
30 can be used in defining event types in event type schemas, and in defining event filters in event filter expressions The 
attr_name specifies the attribute name, and the attr_type specifies the format of the attribute value. 



typedef struct ems_attribute_sj { 

ems_string name; r event attribute name */ 

ems_attr_value_t value; r event attribute type V 

} ems_attribute_t; 

EMS Event Structure 
Event Type 

An event type specifies the unique id for a given event type. 

typedef uuid_t ems_event_type_t ; 



50 



Table 8: 



Default Event Types 


Event Type 


Event Type Name 


ems_c_generic_type 


Generic 
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Table 3: (continued) 



Default Event Types 


Event Type 


Event Type Name 


erns_c_svc_type 


SVC 


ems_c_aud_type 


Audit 



Events of type Generic, do not have event type schemas associated with them, and can only be filtered by ex- 
pressions with header attributes in them. 

Event Identifier 

An event identifier uniquely identifies a given event. Each event normally has both an event type which is unique 
to all events of this type, and an event id which is unique to a specific event. 



20 
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typedef struct ems_eventid_s_t { 

ems_event_type_t type; r event type 7 
uukM id; r Unique event Identifier 

) ems_eventkM; 



7 



Network Name 

A network name identifies the network name of a given host machine. The name service specifies which name 
service recognizes the given network name. 



typedef enum ems_nameservice_s_t { 



ems_ns_other « 0, 


r 


name service other than listed 


7 


ems_ns_dns, 


r 


DNS name service V 




ems_ns_dce, 


r 


DCE CDS name Service */ 




ems_ns_x500, 


r 


X500 7 




ems_ns_nis t 


r 


NIS V 




ems_ns_sna 


r 


SNA network V 





} ems.nameservicej; 



The em$_netaddr_t structure specifies the actual network name. Itcan be interpreted according to the name service 
specified. 



so 



55 



BNSDOCID: <EP 0759561 A 1_l_> 



20 



EP 0 759 591 A1 



10 



15 



typedef char ems_octet_t; r used for NLS support 
typedef struct ems_netaddr_s_t { 

unsigned short len; 

[size_is(Ien)J 

ems_octet_t name(]; 
} ems_netaddr_t; 

typedef struct ems_netname_s_t { 

ems_nameservice_t service; 

[ptr] ems_netaddr_t * netaddr; 
} ems_netname_t; 



7 



r name in appropriate format */ 



r name service used for netname*/ 
r network name/address 7 



20 



For a DCE hostname, the following example will set the ems_netname_t structure; 



25 
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static char* dce_hostname - 7. 7hosts/eagle. austin.ibm.com"; 
ems_netname_t netname; 

netname. service = ems_ns_dce; 

netname netaddr >len » str1en( dce.hostname )+1 ; 

netname. netaddr->name = (char *)malloc( netname.netaddr->len ); 

strcpy( netname. netaddr- >name, dce_hostname ); 
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Event Origin 

The event origin specifies where the event originated (i.e. the supplier). The origin specifies the netname of the 
host where the supplier is running, the name of the supplier, descname, and supplier process identification (pid. uid, 
gid). These values may not be valid for all hosts. 

typedef struct ems_origin_s_t { 

ems_netname_t netname; /* network name of originator host*/ 

[string] char * descname; /* descriptive name of the supplier 7 
unsigned32 pid; r the process id of originator V 

unsigned32 ukj; r the user id of originator V 



so 
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unsigned32 gid; 
} ems_origin_t; 



r the group id of originator V 



Event Severity 

The event severity specifies the severity of the event. The names have a one-to-one correspondence to DCE SVC 
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enum ems_severity_e_t { 




ems_sev_info=G\ 


/* Information event 


ems_sev_fatal. 


T Fatal event */ 


ems_sev_error, 


r Alert event 7 


ems_sev_waming, 


r Warning event 


ems_sev_notice, 


r Notice event V 


ems_sev_notice_verbose , 


r Notice Verbose event 


ems_sev_debug 


r Debug event */ 



7 



*/ 



) ems_severity_t 
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Event Header 



7 



The event header describes the fixed part of the event data structure. The header contains the eventid, the origin 
of the event, the severity along with the time the event was both received at EMS, and delivered to the consumer. 
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typedef struct ems_hdr_s_t { 

ems_eventidj eventid; 

ems_prigin_t origin; 

ems_severity_t severity; 

utc_t received; 

utcj delivered; 
) emsjxlrj; 



r event identifier 7 
r event Origin 7 
r event Seventy 7 
r event received timestamp 
r event delivered timestamp 



7 
7 



A set of Filter attributes are provided for event header filtering. The following names can be used for the filter 
attribute in an event filter expressions: 

Table 9: 



Event Header Attributes 


Attribute Name 


Attribute Type 


eventid. id 


ems_c_attr_uuid 


eventid. type 


ems_c_attr_uuid 


origin. netname. service 


ems_c_attr_ulong 


origin.netname.netaddr 


emc_c_attr_bytes 


origin. descname 


ems_c_attr_char_string 


origin.pid 


ems_c_attr_ulong 


origin.uid 


ems_c_attr_uiong 


origin, gid 


ems_c_attr_ulong 
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Table 9: (continued) 
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Event Header Attributes 


Attribute Name 


Attribute Type 


severity 


ems_c_attr_ulong 


received 


ems_c_attr_utc 



Event 

10 

The ems_ event_t structure contains a fixed part, the event header, and a variable part, the event data items. Each 
data item is a self-defining value which contains an attribute type, and attribute date. A count specifies how many data 
items are in the event. 

75 

typedef struct ems_everrt_s_t { 

ems__hdrj header; r fixed event header 7 

2Q unsigned32 count; r number of data items 7 

(sizejs(count)] 

ems_attribute_t itemfl; r data items 7 

2s } ems_eventj; 

EMS Event Types 

The EMS Event Type structures are used to define the EMS Event types. 

30 

Event Type Schema 

The event type schema is used to define an event type. It consists of an event type id, type, a name field which 
specifies the name of the event type, and a list of event type attributes describing the format of this event type. Size 
35 specifies the number of attributes in an event type. The event type schemas only specifies the fixed part of an event. 
An event can have as many unnamed attributes following the list of attributes specified here. 

4o typedef struct ems_event_type_schema_s_J { 

erns_event_type_t type; r EMS event type 7 



46 [string! char * name; r event type name 7 

long size; r number of attributes 7 

J [sizejs(size)] 

so 

ems_attribute_t attributed; r event type attributes / 

J ems_event_type_schema_t; 

55 Event Type List 

The event type list contains a list of size event type schemas. 
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typedef [ptrj ems_everrt_schema_t * ems_schema __ptr_t; 
typedef slnjct ems_event_type_list_s_t { 

long size; /* number of event type schema 41 V 

[size_is(size)] 

ems_schema_ptr_t schemaf]; r ptr To event type schemas */ 
) ems_eventjypejist_t; 



EMS Event Filters 

is The event filter data structures allow the definition of both event fitters, and event filter lists. 

Attribute Operators 
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Table 10: 



Attribute Operators 


Attribute Operator 
ems_c_attr_op_eq 


Description of Attribute Operator 


TRUE if attr_name equal (= =) to attr_value 


ems_c_attr_op_gt 


TRUE if attr_ name greater than (>) attr_value 


e m s_c_att r_op_ 1 1 


TRUE if attr_name less than (<) attr_yalue 


ems -c_att r_op_ge 


TRUE if attr_name greater than or equal (> =) to attr_value 


ems_c_attr_op_le 


TRUE if attr_name greater than or equal (< =) to attr_value 


em s_c_att r_op_n e 


TRUE if arrr_namenot equal (< >) to attr_value 


ems_c_attr_op_bit and 


TRUE if attr_name bitwise anded with attr_value is greater than 0 


ems_c_attr_op_sub str 


TRUE if attr_name contains the string value specified by attr_value 



Attribute operators define the boolean operation to perform on the attribute name, and the attribute value in the 
event filter expression. The attribute operator type is defined as: 



40 



typedef unsigned 16 ems_attr_op_t; 



45 



SO 



55 



Event Filter Expression 

The event fitter expression structure contains the elements of an event fitter expression that is used to build an 
event fitter. Event fitter expressions contain an attribute name, operator, value triplet (attr_name, attr_operator, 
attr_value) which defines a boolean filter expression. 



typedef struct ems__firter_exp_s_t { 

[string] char * attr_name; 
ems_attr_op_t attr_operator; 
ems_attr_value_t attr_value ; 

} ems_filter_expj; 



r attribute Name V 
r attribute operator V 
r attribute value V 
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Event Filter Expression List 

An event filter expression list groups a list ot filter expressions together in a list to form an ANDed filter expression 
used in defining an event filter. 

typedef struct ems_filter_exp_list_s_t { 

long size; /* number of fitter expressions 7 

(sizejs(size)] 

ems_tilter_exp_t filter_exps[]; /* fitter expressions in list 7 

) ems_filter_exp_li$M; 



Event Filter 

An event filter specifies a series of event filter expressions that will be ANDed together to perform a filter operation. 
The event filter contains a name (fifter_name), which will be entered in the CDS name space, and a list of filter expres- 
20 sions (event_exp_fist). 



typedef struct ems_filter_s_t { 

25 ems_string_t filter_name; r event filter name 7 

ems_event_type_t type, r type of event filter 7 

ems_filter_expJisM filter_expjist; r list of filter expressions 7 
} emsjilterj; 



30 



Filters with event type of generic, can only have filter expressions with header attribute names in them. 
35 Event Filter Name List 

An event filter list contains a list of size event_filter_names; 

40 typedef [string] char * ems_string_t; 

typedef struct ems_filtername_ltst_s_t { 

long size; r number of event filter names V 

45 [size_is(size)J /* event filter names in group 7 

ems_string_t filter_namesQ; 
} ems_filtername_list_t; 



so 



Event Filter List 

The event filter list structure contains a list of size filters. 
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typedef struct ems_firterjist_s_t { 

tong size; F number of event fitters */ 

[size_is(size)J 

emsjfilterj * filtersQ; r event fitter list */ 

) ems_filterjist_t; 



EMS Consumer Data Structures 
Consumer 

75 

The consumer data structure defines an EMS consumer Each consumer has a name, which is entered in CDS, 
a hostname where the consumer is running, and a uuid unique to that consumer. 

20 typedef struct ems_consumer_s_t { 

[stringj char * name; /* DCE name of consumer */ 



ems_netname_t * hostname; r DCE hostname of consumer */ 
uuid_t 
} ems_consumer_t; 



25 uuid t uuid; r consumers uuid 7 



30 Consumer List 

The consumer list structure contains a list of size consumer entries. 

3s typedef struct ems_consu mer Jist_s_t { 



40 long size; r number of consumer entries*/ 

(size_is(size)] 

ems_consumerj consumerfl; /* consumer info V 
45 } ems_consumerJistJ; 

EMS Server Data Structure 
so Attribute List 

The attribute list data structure defines a list of server attributes. Each attribute is a value maintained by an emsd 
server, and the attribute list can be used to query and set those values. 

55 
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typedef struct ems_attrtist_s_t { 

long size; /* number of attributes 7 

(sizejs(size)] 

ems_attribute_t attrfl; r event type attributes 7 

} ems attrlist t; 



Application Programming Interlace (API) 

The following are some representative routines of the EMS API, which implement the RPC interface: 
75 Register with EMS 
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# include <dce/ems.h> 

void ems_register ( 

ems_netname_t * 
ems_handle_t * 
error status_t 1 



hostname, /* DCE host name */ 
handle, /* ems handle */ 

status); /* mgmt request status V 



DESCRIPTION: 

This routine registers with EMS, and obtains an EMS binding handle. This routine can be used by a management 
30 application that will be using the EMS Management or by event suppliers that wish to add new event types. 
Permission required 
None 



PARAMETERS: 
Input 

hostname: is the name of the DCE host machine where emsd is running. If the hostname is NULL, then the 

local host is assumed. 

Output 

handle: returns an EMS handle to use for future calls to EMS routines. 

status: returns the status code from this routine which indicates whether the routine completed successfully 
or, if not, why not. 

The possible status codes and their meaning are as follows: 
error_status_ok. Success 

ems_s_no_memory An EMS handle cannot be allocated. 
ems_s_un suppor t ed_name s e r v ice 

hostname contains an unsupported name service. 



55 
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Remote Supplier Transmit 



void rsupplier_transmit ( 
[in] handle_t 
[in] ems_event_t * 

[out] error_status_t 



handle, 
event , 
status ) ; 



10 
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DESCRIPTION: 

Transmit an event to EMS. 
Permission required 



(w) on /.: /host s/<hostname>/ems-server /event -types /<type_name> 
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PARAMETERS: 
Input 

handle EMS binding handle 
event transmitted event 
Output 

status Returns the status code from this routine which indicates whether the routine completed successfully 
or, if not, why not. 

The possible status codes and their meaning are as follows: 
error_status_ok Success 

ems_s_no_memory EMS server received an error allocating memory 
Remote Consumer Add Event Filters to a Group 



void rconsumer_add_f ilter_to_group ( 
[in] handle_t 
[in] cons_context_t 
[ in] ems_f iltername_ list_t 

[out] error_status_t * 



handle, 

ch, 

£ ilter_list, 
status) ; 



45 



SO 



DESCRIPTION: 

Add the event filters named in fitterjist to a consumer's event fitter group. The consumer is identified by its uuid. 
Permission required 



(w) on /.: /hosts /<hostname>/ ems -server /consumers 



PARAMETERS: 



55 



Input 

handle EMS binding handle 

ch Consumer context handle returned by rconsumer_register. 

filterjist List of event filter names 

Output 
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status Returns the status code from this routine which indicates whether the routine completed successfully 
or, if not, why not. 

The possible status codes and their meaning are as follows: 

5 

error_status_ok Success 
EMS Transmit 

10 

void ems_t transmit ( 

[in] handle_t 
{in] ems_event_t * 

15 [out] error_status_t * 

DESCRIPTION: 

Transmit an event from EMS to a consumer 

20 

PARAMETERS: 
Input 

handle Consumer binding handle 
25 event event 

Output 

status Returns the status code from this routine which indicates whether the routine completed successfully 
or, if not, why not. 



handle , 
event , 
status ) ; 



30 The possible status codes and their meaning are as follows: 



error_status_ok Success 

In a preferred embodiment of the event management service described above a set of instructions in a code module 
35 is resident in the random access memory of a computer. Until required by the computer, the set of instructions may be 
stored in another computer memory, for example, in a hard disk drive, or in a removable memory such as an optical 
disk (for eventual use in a CD ROM) or floppy disk (for eventual use in a floppy disk drive). 

Note that although the various methods described are conveniently implemented in a general purpose computer 
selectively activated or reconfigured by software, one of ordinary skill in the art would also recognize that such methods 
40 may be carried out in hardware, in firmware, or in more specialized apparatus constructed to perform the required 
method steps. 

FIGURE 8 shows a block diagram of a representative general purpose computer system. The system unit 21 
includes a system bus or plurality of system buses 131 to which various components are coupled and by which com- 
munication between the various components is accomplished. The microprocessor 1 32 is connected to the system 
45 bus 131 and is supported by read only memory (ROM) 133 and random access memory (RAM) 134 also connected 
to system bus 1 31 . The microprocessor may be of the Intel family of microprocessors, including the 386 or 486 micro- 
processors, or some other microprocessor such as one of Motorola's family of microprocessors (the 68000, 68020 or 
the 68030 microprocessors) or one of the RISC microprocessors manufactured by IBM, Hewlett Packard, Sun, Intel, 
Motorola and others. 

so The ROM 133 contains among other code the Basic InputOutput system (BIOS) which controls basic hardware 

operations such as the interaction with the disk drives and the keyboard. The RAM 1 34 is the main memory into which 
the operating system and application programs are loaded. The memory management chip 135 is connected to the 
system bus 1 31 and controls direct memory access operations including, passing data between the RAM 1 34 and hard 
disk drive 136 and floppy disk drive 137. The CD ROM 142, also coupled to the system bus 131, is used to store a 

55 large amount of data, e.g., a multimedia program or large database. 

Also connected to this system bus 1 31 are various I/O controllers: the keyboard controller 1 38, the mouse controller 
1 39, the video controller 1 40, and the audio controller 1 41 . The keyboard controller 1 38 provides the hardware interface 
for the keyboard 1 22, the mouse controller 1 39 provides the hardware interface for the mouse 123, the video controller 
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1 40 is the hardware interface tor the display 1 24, and the audio controller 1 41 is the hardware interface for the speakers 
125a and 125b. An I/O controller 150 such as a Token Ring Adapter enables communication over a network 156 to 
other similarly configured data processing systems. 

As seen in FIGURE 8 : the RAM 134 supports the Event Management Service 22 including the filter mechanism 
and queue mechanism. The Threads Service is identified by reference numeral 158 and includes a plurality of thread 
process routines 160a-160n. 

It will be appreciated that although the invention has been described primarily with reference to the OSF DCE 
architecture, it is not so limited, and may be applied to any network environment, whether traditional or object-oriented, 
and so other operating systems and network architectures. 

Claims 

1. A method of managing events in a distributed computing environment wherein one or more event suppliers gen- 
'5 erate events to be communicated to one or more event consumers, comprising the steps of: 

having an event consumer define an event filter group identifying one or more event filters that include infor- 
mation that determines whether particular events generated by the one or more event suppliers are commu- 
nicated to the event consumer; 
20 parsing a plurality of events through the event filter group to identify one or more events to forward to the event 

consumer; and 

communicating to the event.consumer the one or more events identified. 

2. The method of Claim 1 wherein the event filter group includes one or more event filter names identifying the one 
25 or more event filters. 

3. The method of Claim 1 or 2 wherein each event filter of the event filter group includes one or more filter expressions. 

4. The method of Claim 3 wherein the step of parsing events through the event filter group includes the steps of: 

30 

(a) determining whether alt event filters in the event filter group have been evaluated; 

(b) if all event filters in the event filter group have not been evaluated, selecting a next event filter for evaluation: 

(c) determining whether all of the filter expressions in the next event filter evaluate to a predetermined condition; 

(d) if all of the filter expressions in the next event filter evaluate to the predetermined condition, communicating 
35 the event to the event consumer; 

(e) if any of the filter expressions in the event filter do not evaluate to the predetermined condition, returning 
to step (a). 

5. The method of any preceding Claim wherein the information is one or more event type schemas each describing 
40 an event type and comprising a list of attribute nameAype pairs which specify a data format of an event. 

6. The method of Claim 5 wherein an attribute name/type pair comprises an attribute name identifying an attribute 
of a given event type and an attribute type defining the data format in the attribute. 

45 7. The method of Claim 6 wherein each filter expression of the event filter comprises an attribute name, an attribute 
operator and an attribute value, wherein the attribute operator compares the attribute named in the event and the 
attribute value. 



so 



8. The method of any preceding Claim wherein the information is a header attribute associated with an event. 

9. A method of managing events in a distributed computing environment in which users can access distributed re- 
sources and wherein one or more event suppliers generate events to be consumed by one or more event con- 
sumers, comprising the steps of: 

55 having an event consumer define which of a plurality of events generated by the one or more event suppliers 

are to be forwarded to the event consumer; 

having an event management service determine whether an event associated with a predetermined remote 
procedure call (RPC) is one of the plurality of events that is to be forwarded to the event consumer; and 
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if the event associated with the predetermined RPC is one of the plurality of events that is to be forwarded to 
the event consumer, supplying the event from the event management service to the event consumer. 

10. The method of Claim 9 wherein the predetermined RPC is issued from an event recording service. 

5 

11. The method of Claim 9 or 10 wherein the event is supplied from the event management service to the event 
consumer using a remote procedure call. 

12. The method of any of claims 9 to 12, further including the step of registering the event consumer with the event 
10 management service. 

13. The method of Claim 12 further including the step of authenticating the event consumer with a security service. 

14. The method of any of Claims 9 to 13 wherein the event consumer selects which events to receive from the one or 
is more event suppliers by defining an event filter group having one or more event filters. 

15. The method of Claim 14 wherein each event filter of the event filter group comprises a set of filter expressions. 

1 6. The method of Claim 1 5 wherein if all of the filter expressions in a filter evaluate to a predetermined condition, the 
20 filter passes the event, but if any one of the filter expressions in a filter does not evaluate to a predetermined 

condition, the filter does not pass the event. 

17. The method of Claim 16 wherein if the filter does not pass the event, a next filter in the filter group is evaluated. 

25 1 8. The method of any of Claims 9 to 1 7 wherein at least one of the event suppliers is unaware of the event consumers 
who have registered with the event management service to receive that event supplier's events. 

19. The method of any of Claims 9 to 17 further including the step of saving events in an event log. 

30 20. A computer system for use in a distributed computing environment in which users can access distributed resources, 
comprising: 

event management service means for establishing an event channel through which events are passed from 
one or more suppliers to one or more event consumers; and 
35 remote procedure call means for supplying events from the one or more event suppliers to the event manage- 

ment service means, and from the event management service means to the one or more event consumers. 

21. The computer system of Claim 20 further including access control means for authenticating event consumers to 
receive events from the event management service means. 

40 

22. The computer system of Claim 20 or 21 further including event recording service means for providing events from 
the one or more event consumers to the event management service means. 

23. A computer system for providing an event management service in a distributed computing environment in which 
45 users can access distributed resources comprising: 

means for establishing an event channel through which events are passed from one or more event suppliers 
to one or more event consumers; and 

means for filtering the events generated by the one or more event suppliers to determine which events are 
50 passed to the one or more event consumers, wherein the filtering means comprises: 

means for defining an event filter group for each event consumer, the event filter group identifying one or 
more event filters that include information that determines whether particular events generated by the one 
or more event suppliers are communicated to the event consumer; and 
55 means for parsing events through the event filter groups of the event consumers. 

24. The computer system of Claim 23 wherein each event filter group includes one or more event filters. 
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25. The computer system of Claim 24 wherein each event filter of the event filter group includes one or more filter 
expressions. 

26. The computer system of Claim 25 wherein the parsing means evaluates event filters in an event filter group to 
determine whether any event filter includes filter expressions that all evaluate to a predetermined condition. 

27. The computer system of Claim 26 wherein the parsing means passes the events to the event consumer if any 
event filter includes filter expressions that all evaluate to the predetermined condition. 
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